home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Utilities / Unix / top-v0_3 / Source / machine / m_next32.man < prev    next >
Encoding:
Text File  |  1996-02-15  |  3.4 KB  |  78 lines

  1. .SH "NEXTSTEP DIFFERENCES"
  2. NEXTSTEP v.0.3 of TOP  -  2/14/1996 tpugh
  3. The NEXTSTEP port includes reports on the number of threads per process
  4. which appears under the heading "THR".
  5.  
  6. The field "%WCPU" has been removed until we can figure out how to calculate the weighted CPU time with the given process information.
  7.  
  8. Memory statistics show the total RAM for the system, and the number of active,
  9. inactive, wired, and free Mach virtual memory pages (in bytes).  Also shown 
  10. is the number of bytes moving into and out of virtual memory. 
  11.  
  12. The NEXTSTEP port was written by Tim Pugh <tpugh@oce.orst.edu>.
  13.  
  14. COMPATIBILITY - next32
  15. This is the machine-dependent module for NEXTSTEP v3.x
  16. Reported to work for NEXTSTEP v3.0, v3.2, and v3.3 Mach OS:
  17.     NEXTSTEP v3.0 on Motorola machines.
  18.     NEXTSTEP v3.2 on Intel and Motorola machines.
  19.     NEXTSTEP v3.3 on Intel and Motorola machines.
  20. Problem with command column for (Choose next40 for fix):
  21.     NEXTSTEP v3.2 on HP machines.
  22.     NEXTSTEP v3.3 on HP and Sparc machines.
  23. Has not been tested for NEXTSTEP v2.x machines, although it should work.
  24. Has not been tested for NEXTSTEP v3.1 machines, although it should work.
  25.  
  26. COMPATIBILITY - next40
  27. This is the machine-dependent module for NEXTSTEP v3.x/4.x
  28. Reported to work for:
  29.     NEXTSTEP v3.2 on HP machines.
  30.     NEXTSTEP v3.3 on HP and Sparc machines.
  31. Has not been tested for NEXTSTEP v4.0 machines, although it should work.
  32.  
  33.  
  34. HISTORY
  35. *  9/8/95  tpugh.  Removed the %WCPU field, no support for it.
  36. *  9/8/95  tpugh.  Removed all C++ style comments from machine.c to be
  37. ANSI C compatible.
  38. * 2/13/96 tpugh.  Fixed command name display problem for hppa and sparc
  39. machines,and NS4.0 alpha machines.  NeXT changed the task structure, so 
  40. top could not find utask structure.  <mach/task.h> is not shipped with 
  41. any NEXTSTEP system.
  42. * 2/14/96 tpugh.  Reduced line length to less than 80 columns.  Some commands
  43. are long and will extend beyond 80 colums.
  44. * 2/14/96 tpugh.  Fixed "top -U" fails with bus error.  In special cases 
  45. where only a specific user is displayed, the process index variable was 
  46. being improperly advanced, resulting in zero process address values 
  47. and bus errors.
  48. * 2/14/96 tpugh.  Eliminated the text artifacts in the command column.
  49.  
  50. FREQUENTLY ASKED QUESTIONS
  51. #1:  top 3.3 (after configuring for next32 with all defaults) on my i386 
  52. running NEXTSTEP 3.3, I get:  Error calling task_by_unix_pid(): failure(5)
  53.  
  54. Answer:
  55. The call is failing because you do not have permission.  You must be the superuser, root, or the program must have root privileges to work properly.  It's been reported that setting the group sticky bit for kmem does not work, and the fix is to set the user sticky bit for root.  So install "top" with the permissions 4755.
  56.  
  57. As root, do the following:
  58.  
  59. tsunami# chown root.kmem top
  60. tsunami# chmod 4755 top
  61. tsunami# ls -lg top
  62. -rwsr-xr-x  1 root     kmem      121408 Sep  1 10:14 top*
  63.  
  64. With the kmem group sticky bit set, we can read kernal memory without problems, but to communicate with the Mach kernal for task and thread info, it requires root privileges.
  65.  
  66.  
  67. #2:  How to compile top to create a multiple binary file or FAT?
  68.  
  69. Answer:
  70. Added the -arch flags.  Due to the task.h file differences between (m68k,Intel) and (sparc,hppa) NEXTSTEP operating systems, a single binary file can be generated, except for NS4.0 machines.
  71.  
  72. Change line 64 to:
  73. CFLAGS = -DSHOW_UTT -arch m68k -arch i386 -arch hppa -arch sparc $(CDEFS)
  74.  
  75. Added $(CFLAGS).  Change line 79 to:
  76.     $(CC) $(CFLAGS) -o top $(OBJS) -ltermcap -lm $(LIBS)
  77.  
  78.